home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Language/OS - Multiplatform Resource Library
/
LANGUAGE OS.iso
/
smaltalk
/
manchest.lha
/
MANCHESTER
/
usenet
/
st80_pre4
/
pretty-print
/
README
< prev
next >
Wrap
INI File
|
1993-07-24
|
3KB
|
82 lines
[Instructions seem to be in the comments in smalltalkToTexMacro.doc]
From: rebecca@small (Rebecca Y. Shen)
Newsgroups: comp.lang.smalltalk
Subject: Pretty-printing Smalltalk via TeX
Keywords: printing, TeX, Smalltalk
Message-ID: <1991Oct6.014503.4042@cco.caltech.edu>
Date: Sun, 6 Oct 91 02:45:03 BST
Organization: California Institute of Technology, Pasadena
A while ago someone asked about producing nicely formatted Smalltalk
code (specifically it was having footers with the class name), and
hopefully I will now overkill that request for those of you that
have TeX available to you.
SmalltalkToTex is a TeX macro that can read a Smalltalk chunk file
and format it with TeX.
Fairly common stuff:
1) formats all the special characters (^,_,:=,etc.),
2) wraps and indents long lines
3) formats comments and message selectors
4) breaks pages between classes
Uncommon stuff:
1) produces headers and footers with:
class name, section name
page number (within the class)
print time
and by adding comments to your Smalltalk file (which
Smalltalk could automatically generate) the head/foot
could include:
class hierarchy, category, version, and whatever
else you consider important.
2) can print in 2-column mode,
3) inhibits methods from splitting between pages,
4) line-numbers (ich, but can be useful)
Really uncommon stuff:
1) works with LaTeX and Texinfo, and can:
* add table of contents entries for classes, class sections,
and subsections (eg: method categories)
* add index entries for message selectors
2) can include diagrams (again by adding comments to your Smalltalk
file).
3) There are no intermediary files; the macro can read a chunk
format file directly.
Since the macros can't really read Smalltalk, they do not format
the method code itself; they don't format messages differently from
variables, or format local, instance, and pool variables differently
from each other.
There is a lot of flexibility in the output courtesy of TeX: you
have access to many fonts, the information from the Smalltalk file
can be processed quite a bit, special characters used in the output,
and so on.
The macros work in TeX but don't require much (if any) knowledge of TeX.
If you like one of the demo formats you don't ever need to touch TeX code.
If you don't have TeX and would like to, there are inexpensive and
free versions of it available, as well as expensive versions if you
would prefer.
I tried to include reasonable documentation, a good set of examples,
and to test the macros on many types of files, and I hope
smalltalkToTex will be useful to most of you; if it is not,
please tell me why. The program is a version of shareware (dinnerware).
Send me any comments and bug reports via:
rebecca@tybalt.caltech.edu
who will get them to me.
-- Mark L. Fussell